home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / wc3x / sdiz11.zip / SDIZ.DOC < prev    next >
Text File  |  1992-08-29  |  7KB  |  160 lines
  1.  
  2.  
  3.                         SDIZ v1.1 for WILDCAT! v 3.5
  4.                              User Documentation
  5.  
  6.                         Copyright 1992 by Tim Kilgore
  7.                Protected under Missouri General Copyright Laws
  8.                              ALL RIGHTS RESERVED
  9.  
  10.  
  11.   What is SDIZ?
  12.  
  13.         SDIZ is a comment inserter designed to be used as a part of MSI's
  14.         WILDCAT! v3.5x's SCANFILE.BAT.  It will insert the text contained
  15.         in FILE_ID.DIZ or DESC.SDI if an uploaded archive contains either
  16.         of these standardized description files.
  17.  
  18.   New for version 1.1
  19.  
  20.         Version 1.0 was written with three routines from an external
  21.         library.  One of the routines was broken and had the potential
  22.         of causing occasional lock-ups.  Version 1.1 is written entirely
  23.         in BASIC 7.1 and should not lock-up.
  24.  
  25.         This version does NOT process DESC.SDI if FILE_ID.DIZ is located.
  26.         This prevents duplicate descriptions for occurring.
  27.  
  28.         This version has a high-bit filter.  This means that boxes drawn
  29.         around file descriptions will not appear (staggered and ugly as
  30.         a result) in WILDCAT's description file.  All characters with an
  31.         ASCII value > 127 will NOT appear in a file description.
  32.  
  33.         NOTE:  I have discovered that ARCID occassionally identifies a
  34.                a GIF as being a HYPER compressed file.  You may wish to
  35.                remove support for *.HYP files.
  36.  
  37.   Disclaimer -
  38.  
  39.         YOUR USE OF SDIZ.EXE INIDCATES YOUR AGREEMENT WITH THE FOLLOWING
  40.         TERMS.  THE AUTHOR, TIM KILGORE, WILL NOT BE HELD RESPONSIBLE FOR
  41.         ANY DAMAGES CAUSED BY SDIZ.EXE.  YOU USE SDIZ.EXE AT YOUR OWN RISK.
  42.  
  43.  
  44.   Why SDIZ?
  45.  
  46.         At the time of this writing, there are at least 5 other programs
  47.         available to process uploads for FILE_ID.DIZ or DESC.SDI.  Due to
  48.         conflicts with LANtastic drivers, partial functionality, or just
  49.         bad coding, I've been 'forced' to write SDIZ to handle a fairly
  50.         simple task.  None of the existing 5 programs meet _my_ personal
  51.         needs.
  52.  
  53.         I've also taken the time to add some extended functionality and
  54.         SDIZ has a unique combination of capabilites.  Thanks to the
  55.         archive identification of Stacy Smith's ARCID, SDIZ can process -
  56.  
  57.                    o  *.SDN files (PAK).
  58.                    o  ARC, ARJ, HYP, LZH, PAK, ZIP, and ZOO files.
  59.                    o  Self-extracting (EXE) archives of any type.
  60.  
  61.         Finally, SDIZ is FREEWARE.  I'm asking no compensation of any
  62.         kind.  I do ask that you register Smith's ARCID ($5); it's a fine
  63.         tool and can be used for many other tasks.
  64.  
  65.  
  66.   You'll Probably Need ARCID -
  67.  
  68.         SDIZ relies upon Stacy Smith's ARCID to determine the archive
  69.         type.  ARCID093.ARJ was uploaded to the WildCat! HQ BBS and is
  70.         just under 20k in size.  In the event that you need a more
  71.         current version or want to get it elsewhere, ARCID's home BBS
  72.         is -
  73.  
  74.                         The Bloom Beacon-Picayune BBS
  75.                                (804) 525-9760
  76.                      300-14,400 Baud (USRobotics V.32bis)
  77.                               FidoNet 1:276/112
  78.  
  79.         It is likely that other programs exist that determine the type
  80.         of archiver used to create a particular archive.  Feel free to
  81.         use whatever you are comfortable with.
  82.  
  83.   Using SDIZ with ARCID -
  84.  
  85.         Following this section is a sample SCANFILE.BAT that should work
  86.         on any system if both ARCID.EXE and SDIZ.EXE are placed in the
  87.         path.  I recommend skipping to this section as the following
  88.         notes may be damaging to your wakefulness.
  89.  
  90.         SDIZ is designed to be operated from the NODEx subdirectory.  Two
  91.         directories up (usually WC30 or WC) should be the main BBS sub-
  92.         directory and FILEAREA.DAT.  On my system, SDIZ is executed from -
  93.  
  94.                               C:\WC\WCWORK\NODE1\
  95.  
  96.         This is important because SDIZ will execute the following command
  97.         prior to calling WCFILE.EXE -
  98.  
  99.                               CD ..\..
  100.  
  101.         This command should put SDIZ in the WC main subdirectory.  SDIZ also
  102.         attempts to open "..\..\FILEAREA.DAT".  Again, SDIZ looks 'up'
  103.         two subdirectories and will fail to function if it cannot do so.
  104.  
  105.         SDIZ's command line appears as -
  106.  
  107.                 SDIZ  Drive:\path\filename.ext ARCHIVE-TYPE
  108.  
  109.         The drive and path must match one found as a primary path in
  110.         FILEAREA.DAT.  During an upload, it is impossible for it not to
  111.         match, so don't worry about this too much.
  112.  
  113.         ARCHIVE-TYPE is provided by ARCID (or similar program) and can
  114.         be any of the following -
  115.  
  116.                       ARC, ARJ, HYP, LZH, PAK, ZIP, ZOO
  117.  
  118.         Once SDIZ is up and running, it will attempt to extract both
  119.         FILE_ID.DIZ and DESC.SDI from the upload.  If either file is
  120.         extracted, SDIZ will process the description file(s) and then
  121.         start WCFILE.EXE.
  122.  
  123.  
  124.   Example SCANFILE.BAT -
  125.  
  126.         For the most part, this batch file is plug and play.  It is
  127.         worth mentioning that ARCID _can_ detect GIF files.  There is
  128.         at least one GIF processor available (inserts resolution), so
  129.         you may want to use this feature.
  130.  
  131.         @echo off
  132.         CD \WC30\WCWORK\NODE%WCNODEID%
  133.         REM If you have Mike Ortiz's CATSCAN, then remove the following REM
  134.         REM CATSCAN %1
  135.         ARCID %1 ARC ARJ ZIP LZH ZOO PAK HYP
  136.         if errorlevel 7 SDIZ %1 HYP
  137.         if errorlevel 6 SDIZ %1 PAK
  138.         if errorlevel 5 SDIZ %1 ZOO
  139.         if errorlevel 4 SDIZ %1 LZH
  140.         if errorlevel 3 SDIZ %1 ZIP
  141.         if errorlevel 2 SDIZ %1 ARJ
  142.         if errorlevel 1 SDIZ %1 ARC
  143.  
  144.  
  145.   Contacting the Author -
  146.  
  147.         If you've got a burr under your saddle, have a comment or suggestion,
  148.         or just want to say thanks, Tim Kilgore can be reached at -
  149.  
  150.                                 Planet ><
  151.                                FIDO 1:289/5
  152.                             314-443-0319 HST/DS
  153.                              314-442-0187 v.32
  154.                              314-874-5887 v.32
  155.  
  156.         By the way, if you use SDIZ and have written a nifty WC utility or
  157.         a door, don't hesitate to say thanks by sending the author a key or
  158.         registered copy of your program <g>.
  159.  
  160.